<{extend name="Public:public0" /}>

<{block name="title"}>安装 与 介绍<{/block}>

<{block name="sidebar"}><{include file="Public:sidebar-vuecli" /}><{/block}>

<{block name="head"}>
	<link rel="stylesheet" type="text/css" href="__ROOT__/css/vuex.css"/>
<{/block}>

<{block name="content"}>

<div class="content guide with-sidebar components-guide">
	<h2 id="introduce">
		<a href="#introduce" class="headerlink" title="introduce" data-scroll="">介绍</a>
	</h2>	
	<p class="bit-sponsor"><a href="https://www.bitsrc.io/?utm_source=vue&amp;utm_medium=vue&amp;utm_campaign=vue&amp;utm_term=vue&amp;utm_content=vue"
		 target="_blank"><span>This project is sponsored by</span> <img alt="bit" src="https://raw.githubusercontent.com/vuejs/vuejs.org/master/themes/vue/source/images/bit-wide.png"></a></p>
	<div class="warning custom-block">
		<p class="custom-block-title">警告</p>
		<p>这份文档是对应 <code>@vue/cli</code> <strong>3.x</strong> 版本的。老版本的 <code>vue-cli</code> 文档请移步<a href="https://github.com/vuejs/vue-cli/tree/v2#vue-cli--"
			 target="_blank" rel="noopener noreferrer">这里<svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" x="0px" y="0px"
				 viewBox="0 0 100 100" width="15" height="15" class="icon outbound">
					<path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path>
					<polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon>
				</svg></a>。</p>
	</div>
	<p>Vue CLI 是一个基于 Vue.js 进行快速开发的完整系统，提供：</p>
	<ul>
		<li>通过 <code>@vue/cli</code> 搭建交互式的项目脚手架。</li>
		<li>通过 <code>@vue/cli</code> + <code>@vue/cli-service-global</code> 快速开始零配置原型开发。</li>
		<li>一个运行时依赖 (<code>@vue/cli-service</code>)，该依赖：
			<ul>
				<li>可升级；</li>
				<li>基于 webpack 构建，并带有合理的默认配置；</li>
				<li>可以通过项目内的配置文件进行配置；</li>
				<li>可以通过插件进行扩展。</li>
			</ul>
		</li>
		<li>一个丰富的官方插件集合，集成了前端生态中最好的工具。</li>
		<li>一套完全图形化的创建和管理 Vue.js 项目的用户界面。</li>
	</ul>
	<p>Vue CLI 致力于将 Vue 生态中的工具基础标准化。它确保了各种构建工具能够基于智能的默认配置即可平稳衔接，这样你可以专注在撰写应用上，而不必花好几天去纠结配置的问题。与此同时，它也为每个工具提供了调整配置的灵活性，无需
		eject。</p>
	<h2 id="该系统的组件"><a href="#该系统的组件" aria-hidden="true" class="header-anchor">该系统的组件</a></h2>
	<p>Vue CLI 有几个独立的部分——如果你看到了我们的<a href="https://github.com/vuejs/vue-cli/tree/dev/packages/%40vue" target="_blank" rel="noopener noreferrer">源代码<svg
			 xmlns="http://www.w3.org/2000/svg" aria-hidden="true" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15"
			 class="icon outbound">
				<path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path>
				<polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon>
			</svg></a>，你会发现这个仓库里同时管理了多个单独发布的包。</p>
	<h3 id="cli"><a href="#cli" aria-hidden="true" class="header-anchor">CLI</a></h3>
	<p>CLI (<code>@vue/cli</code>) 是一个全局安装的 npm 包，提供了终端里的 <code>vue</code> 命令。它可以通过 <code>vue create</code>
		快速创建一个新项目的脚手架，或者直接通过 <code>vue serve</code> 构建新想法的原型。你也可以通过 <code>vue ui</code> 通过一套图形化界面管理你的所有项目。我们会在接下来的指南中逐章节深入介绍。</p>
	<h3 id="cli-服务"><a href="#cli-服务" aria-hidden="true" class="header-anchor">CLI 服务</a></h3>
	<p>CLI 服务 (<code>@vue/cli-service</code>) 是一个开发环境依赖。它是一个 npm 包，局部安装在每个 <code>@vue/cli</code> 创建的项目中。</p>
	<p>CLI 服务是构建于 <a href="http://webpack.js.org/" target="_blank" rel="noopener noreferrer">webpack<svg xmlns="http://www.w3.org/2000/svg"
			 aria-hidden="true" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound">
				<path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path>
				<polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon>
			</svg></a> 和 <a href="https://github.com/webpack/webpack-dev-server" target="_blank" rel="noopener noreferrer">webpack-dev-server<svg
			 xmlns="http://www.w3.org/2000/svg" aria-hidden="true" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15"
			 class="icon outbound">
				<path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path>
				<polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon>
			</svg></a> 之上的。它包含了：</p>
	<ul>
		<li>加载其它 CLI 插件的核心服务；</li>
		<li>一个针对绝大部分应用优化过的内部的 webpack 配置；</li>
		<li>项目内部的 <code>vue-cli-service</code> 命令，提供 <code>serve</code>、<code>build</code> 和 <code>inspect</code> 命令。</li>
	</ul>
	<p>如果你熟悉 <a href="https://github.com/facebookincubator/create-react-app" target="_blank" rel="noopener noreferrer">create-react-app<svg
			 xmlns="http://www.w3.org/2000/svg" aria-hidden="true" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15"
			 class="icon outbound">
				<path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path>
				<polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon>
			</svg></a> 的话，<code>@vue/cli-service</code> 实际上大致等价于 <code>react-scripts</code>，尽管功能集合不一样。</p>
	<p><a href="/zh/guide/cli-service.html" class="">CLI 服务</a>章节涵盖了它的具体用法。</p>
	<h3 id="cli-插件"><a href="#cli-插件" aria-hidden="true" class="header-anchor">CLI 插件</a></h3>
	<p>CLI 插件是向你的 Vue 项目提供可选功能的 npm 包，例如 Babel/TypeScript 转译、ESLint 集成、单元测试和 end-to-end 测试等。Vue CLI 插件的名字以 <code>@vue/cli-plugin-</code>
		(内建插件) 或 <code>vue-cli-plugin-</code> (社区插件) 开头，非常容易使用。</p>
	<p>当你在项目内部运行 <code>vue-cli-service</code> 命令时，它会自动解析并加载 <code>package.json</code> 中列出的所有 CLI 插件。</p>
	<p>插件可以作为项目创建过程的一部分，或在后期加入到项目中。它们也可以被归成一组可复用的 preset。我们会在<a href="/zh/guide/plugins-and-presets.html" class="">插件和
			preset</a> 章节进行深入讨论。</p>
	<br><br><br>
	
	
	
	<h2 id="installation">
		<a href="#installation" class="headerlink" title="installation" data-scroll="">安装</a>
	</h2>	
	<div class="warning custom-block">
		<p class="custom-block-title">关于旧版本</p>
		<p>Vue CLI 的包名称由 <code>vue-cli</code> 改成了 <code>@vue/cli</code>。
			如果你已经全局安装了旧版本的 <code>vue-cli</code> (1.x 或 2.x)，你需要先通过 <code>npm uninstall vue-cli -g</code> 或 <code>yarn global
				remove vue-cli</code> 卸载它。</p>
	</div>
	<div class="tip custom-block">
		<p class="custom-block-title">Node 版本要求</p>
		<p>Vue CLI 需要 <a href="https://nodejs.org/" target="_blank" rel="noopener noreferrer">Node.js<svg xmlns="http://www.w3.org/2000/svg"
				 aria-hidden="true" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound">
					<path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path>
					<polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon>
				</svg></a> 8.9 或更高版本 (推荐 8.11.0+)。你可以使用 <a href="https://github.com/creationix/nvm" target="_blank" rel="noopener noreferrer">nvm<svg
				 xmlns="http://www.w3.org/2000/svg" aria-hidden="true" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15"
				 class="icon outbound">
					<path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path>
					<polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon>
				</svg></a> 或 <a href="https://github.com/coreybutler/nvm-windows" target="_blank" rel="noopener noreferrer">nvm-windows<svg
				 xmlns="http://www.w3.org/2000/svg" aria-hidden="true" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15"
				 class="icon outbound">
					<path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path>
					<polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon>
				</svg></a> 在同一台电脑中管理多个 Node 版本。</p>
	</div>
	<p>可以使用下列任一命令安装这个新的包：</p>
	<div class="language-bash extra-class">
		<pre class="language-bash"><code><span class="token function">npm</span> <span class="token function">install</span> -g @vue/cli
	<span class="token comment"># OR</span>
	yarn global add @vue/cli
	</code></pre>
	</div>
	<p>安装之后，你就可以在命令行中访问 <code>vue</code> 命令。你可以通过简单运行 <code>vue</code>，看看是否展示出了一份所有可用命令的帮助信息，来验证它是否安装成功。</p>
	<p>你还可以用这个命令来检查其版本是否正确 (3.x)：</p>
	<div class="language-bash extra-class">
		<pre class="language-bash"><code>vue --version
	</code></pre>
	</div>		
			
			
			
</div>








<{/block}>
